docs: add getting started on testnet guide#22366
Merged
critesjosh merged 6 commits intonextfrom Apr 16, 2026
Merged
Conversation
aa42adb to
11fcf02
Compare
Updated testnet getting started guide to use the Sponsored FPC at 0x2ae02a54fd254586fd628ff46b71071bd8db32b63dc5d083f844f2c208a3923c instead of requiring users to bridge Fee Juice manually. Also updated networks.md, how_to_pay_fees.md, and devnet guide to reflect that Sponsored FPC is now available on testnet.
Copy getting_started_on_testnet.md to both versioned doc directories (v4.2.0-aztecnr-rc.2 and v4.1.0-rc.2), update versioned sidebars, and fix Sponsored FPC availability notes in versioned fee docs.
5952222 to
5abfaa3
Compare
…ting-started-docs # Conflicts: # docs/developer_versioned_docs/version-v4.2.0/docs/aztec-js/how_to_pay_fees.md # docs/developer_versioned_docs/version-v4.2.0/getting_started_on_testnet.md # docs/docs-developers/docs/aztec-js/how_to_pay_fees.md # docs/docs/networks.md
critesjosh
approved these changes
Apr 16, 2026
Collaborator
Author
|
❌ Failed to cherry-pick to |
AztecBot
pushed a commit
that referenced
this pull request
Apr 16, 2026
Adds a new "Getting Started on Testnet" documentation page addressing developer questions about deploying to testnet. This was requested because the docs currently guide developers to the local network but don't explain how to use testnet. The guide uses the **Sponsored FPC** at `0x2ae02a54fd254586fd628ff46b71071bd8db32b63dc5d083f844f2c208a3923c` for fee payment, so developers can get started without bridging Fee Juice from L1. The new page covers: - Installing the correct testnet version of the CLI - Registering the Sponsored FPC and using it for fee payment - Creating and deploying accounts - Deploying and interacting with contracts (Token example) - Viewing transactions on Aztecscan - Registering existing contracts in PXE - Link to manual fee bridging docs for advanced users Also updates: - `sidebars-developer.js` — added testnet page between local network and devnet - `networks.md` — added Sponsored FPC address for testnet, updated links and notes - `how_to_pay_fees.md` — removed conditional blocks saying Sponsored FPC isn't on testnet - `getting_started_on_devnet.md` — removed stale testnet warning about Sponsored FPC - `getting_started_on_local_network.md` — cross-links to testnet guide - [ ] Run `yarn start` in docs/ and verify the new page renders correctly - [ ] Verify sidebar shows the testnet page between local network and devnet - [ ] Verify cross-links from networks.md and local network page work - [ ] Verify preprocessor macros (`#include_testnet_version`) resolve correctly - [ ] Confirm Sponsored FPC address `0x2ae02a54fd254586fd628ff46b71071bd8db32b63dc5d083f844f2c208a3923c` is correct and funded
critesjosh
added a commit
that referenced
this pull request
Apr 16, 2026
Backport of #22366 to `v4-next`. ## Summary Adds a "Getting Started on Testnet" guide and cross-links it from the local network guide and the developer sidebar. Single commit, docs-only, no code changes. ## Cherry-pick notes `git cherry-pick -m 1 3b8d1f3` produced no conflict markers — only a file-location warning because the PR added its versioned copy under `docs/developer_versioned_docs/version-v4.2.0/` (the latest versioned docs dir on `next`), and on this branch the equivalent directory is `version-v4.1.0-rc.2/`. Git's rename detection mapped the new file to the correct backport location; resolution was just `git add` + `cherry-pick --continue`. This matches how prior backports (#22232, #22193, etc.) have updated the v4.1.0-rc.2 versioned copies. No conflict-resolution or build-fix commits were needed, so this is a single clean commit rather than the 3-commit backport shape. Analysis gist: https://gist.github.com/AztecBot/1cc7e89de52ec1fdaef0b2194addf1af ClaudeBox log: https://claudebox.work/s/90bb9caf79cca71d?run=1
Thunkar
added a commit
that referenced
this pull request
Apr 17, 2026
BEGIN_COMMIT_OVERRIDE fix(pxe): cap event filter toBlock to last synced block (#22573) fix(pxe): round tx expiration timestamp to reduce precision (#22577) fix: eliminate anvil watcher warp race and false success logs (#22584) refactor: aztec new and init creating 2 crates (#20681) test: aztec new scaffold works (#20711) feat(cli): warning if contract crate has tests (#20723) feat(cli): auto-recompiling when aztec test is run (#20729) feat: aztec new supporting multiple contract crates (#21007) feat: asserts that aztec dep version matches cli (#21245) chore: backport aztec CLI improvements to v4-next (#22587) feat: check noir release has nargo binaries before releasing (#22551) chore: cache chainInfo in embeddedwallet (#22592) fix: wrap external getCapsule in transactionAsync (#22595) fix(pxe): throw clear error for invalid comparator in pick_notes (#22585) refactor(aztec-nr): rename conversion fns to encode_/decode_ naming (#22576) feat: infrastructure for testing `[new_contract_artfiacts, old_aztec_stack]` (#22593) chore: fix unnecessary and inconsistent side-effect counter increments (#22245) fix: update FaceID wallet redirects and strip anchors in redirect validation (#22505) docs: add getting started on testnet guide (#22366) docs: add getting started on testnet guide (backport #22366) (#22619) feat(aztec-nr): new BoundedVec emit private log APIs (#22064) END_COMMIT_OVERRIDE
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a new "Getting Started on Testnet" documentation page addressing developer questions about deploying to testnet. This was requested because the docs currently guide developers to the local network but don't explain how to use testnet.
The guide uses the Sponsored FPC at
0x2ae02a54fd254586fd628ff46b71071bd8db32b63dc5d083f844f2c208a3923cfor fee payment, so developers can get started without bridging Fee Juice from L1.The new page covers:
Also updates:
sidebars-developer.js— added testnet page between local network and devnetnetworks.md— added Sponsored FPC address for testnet, updated links and noteshow_to_pay_fees.md— removed conditional blocks saying Sponsored FPC isn't on testnetgetting_started_on_devnet.md— removed stale testnet warning about Sponsored FPCgetting_started_on_local_network.md— cross-links to testnet guideTest plan
yarn startin docs/ and verify the new page renders correctly#include_testnet_version) resolve correctly0x2ae02a54fd254586fd628ff46b71071bd8db32b63dc5d083f844f2c208a3923cis correct and funded